home
***
CD-ROM
|
disk
|
FTP
|
other
***
search
/
BBS Toolkit
/
BBS Toolkit.iso
/
pc_board
/
adlg17b.zip
/
ADLOGO.DOC
< prev
next >
Wrap
Text File
|
1992-02-13
|
18KB
|
434 lines
▒▒▒▒▒▒ ▒▒▄
▒▒█▀▀▀▀▀▒▒▄ ▒▒█
▒▒█ ▒▒█ ▒▄ ▒▒█
▒▒█ ▒▒█ ▒█ ▒▒█
▒▒█ ▒▒█ ▒█ ▒▒█
▒▒▒▒▒▒▒▒▒▒█ ▒▒▒▒▒▒▒█ ▒▒█ ▒▒▒▒▒▒▒▄ ▒▒▒▒▒▒▒▄ ▒▒▒▒▒▒▒▄
▒▒██████▒▒█ ▒█▀▀▀▀▒█ ▒▒█ ▒█▀▀▀▀▒█ ▒█▀▀▀▀▒█ ▒█▀▀▀▀▒█
▒▒█ ▒▒█ ▒▒▒▒▒▒▒█ ▒▒▒▒▒▒▒▒▒▄ ▒▒▒▒▒▒▒█ ▒▒▒▒▒▒▒█ ▒▒▒▒▒▒▒█
▀▀ ▀▀ ▀▀▀▀▀▀▀ ▀▀▀▀▀▀▀▀▀ ▀▀▀▀▀▀▀ ▀▀▀▀▀▒█ ▀▀▀▀▀▀▀
▒█
▒▒▒▒▒▒█
▀▀▀▀▀▀
AdLogo v1.4ßeta Page 1
AdLogo v1.4ßeta
by
Michael J. Cambra
Licensed to TMC SoftWare/OTS Software Development Corp.
WHAT IS IT??
------------
AdLogo is a PCBoard utility that will add your BBS's ZIP 'Logo'
(ZipComment) to those files that are located on your CD-ROM.
You say that you don't have a CD-ROM? No problem. After a period
of time (Months, Years) you have problably changed your ZipComment
at least a few times and only those files that have been received
since the last time your have changed your logo, will contain it.
AdLogo will also change those outdated ZipComments (from herein
called 'Logo') to your most recent 'Logo'.
WHAT OTHER PURPOSE DOES IT HAVE?
--------------------------------
Great question! Let's say you have 2000 files on your board that are
downloadable files and each of those files contains your board's
'Logo'. If the average size of each 'Logo' that is contained in those
files is 2000 bytes (or 2K). We then take 2000 times the size of the
'Logo' and that comes out to be a total of 4meg!! 4meg of space
wasted JUST by those files containing your board's 'Logo'. Plus, this
4meg figure is increased EVERYTIME a new file is placed on your system!
Well, with AdLogo, you can gain back that wasted 4meg+ and STILL have
every ZIP file that is downloaded by your users contain your board's
'Logo' by simply removing the current 'Logo' from all of those files.
(This may sound like a big job, however, it isn't. There are shareware
utils that will make this job painless!)
HOW?
---
AdLogo will add your board's 'Logo' to each .ZIP file that a user
chooses to download RIGHT before the transfer is started.
AdLogo v1.4ßeta Page 2
OPERATION
---------
AdLogo is placed is all of your board's PCBS?.BAT files one line before
the command line for the transfer protocol. When PCBoard Shell's out
to the batch file, AdLogo will do the following:
1) First it will determind if the transfer is a SIGNLE file download
or a BATCH downlaod.
2) It will then check each file and determine if it/they are located
on a MATCHED CD-ROM (or MATCH HARD DRIVE, herein called CD-ROM)
3) If any of the files are on the CD-ROM, it will then copy the file
over to a TEMP directory, and add your board's comment to each file.
If the file(s) is/are not a .ZIP, or not on a MATCHED CD-ROM, the file(s)
are not touched in anyway.
SYNTAX
------
AdLogo <CFGFILE> %NODE% %3
CFGFILE -- is the full path and filename of the configuration
file that you are using. This .CFG file can be named
valid DOS filename (ie: C:\PCB\ADLOGO.CFG)
(See end of docs for format of .CFG file)
%NODE% -- this is the enviroment NODE setting. You probably
already have this setting defined in each of your
board's BOARD.BAT file. However, if you do not, simply
add a line somewhere before the PCB145.EXE command like
this: SET NODE=n (where 'n' is the number for this node's
nodes BOARD.BAT file-Single Node Systems, use 1)
%3 -- Place %3 as the last argument on the AdLogo command
line. This is the filename, or text file of the paths
of the filenames in a batch transfer, that PCBoard
passes to the PCBS?.BAT files
An example of the AdLogo command line would be like this:
AdLogo C:\PCB\ADLOGO.CFG %NODE% %3
AdLogo v1.4ßeta Page 3
INSTALLATION
------------
Installing AdLogo into your system is easy and should take no more
than 10 minutes!
First, decide what drive you are going to place your TEMP directory
on. (HINT: Choose your FASTEST hard drive!). Then choose the name
of your TEMP directory. You call this directory ANYTHING you wish,
as long as it is a valid DOS directory name. Now create the TEMP
directory on the drive your chose.
NOTE: If you are running a Multi-Node system, you
MUST create different TEMP directory for each
Node! (ie N:\TEMP1, N:\TEMP2, etc...)
If you are running a SINGLE Node system, you
MUST create the directory with the number 1
as the last character! (ie: N:\TEMP1)
Second, copy AdLOGO.EXE to a directory that is defined in your DOS
PATH statement. (HINT: For FASTEST execution, try to place AdLogo.exe
in one of the FIRST directories listed in your PATH statement.)
Third, edit each of your PCBSZ.BAT files. If you have added other
protocols to your system, you edit these as well. However, we will
use PCBSZ.BAT (Which is the ZModem download batch file for the
examples).
The first thing we you will need to do is place your AdLogo
command line right before the DSZ command line.
Here is an example of what we are doing:
PCBSZ.BAT before AdLogo:
@echo off
if exist pcberr.fil del pcberr.fil
if exist pcbdsz.lgo del pcbdsz.log
DSZ port %1 handshake both pB4096 estimate 0 %5 z sz -r %3
PCBSZ.BAT After adding AdLogo
@echo off
if exist pcberr.fil del pcberr.fil
if exist pcbdsz.log del pcbdsz.log
AdLogo C:\PCB\ADLOGO.CFG %NODE% %3
DSZ port %1 etc....
AdLogo v1.4ßeta Page 4
Now we must change the %3 in the DSZ command line to read
'@%DRIVE%ADLOGO.LST' (without the quotes).
DSZ port %1 handshake BOTH pB4096 estimate 0 %5 z sz -r @%DRIVE%ADLOGO.LST
NOTE: In each of your node's BOARD.BAT file, you must create
a SET DRIVE=n enviroment setting where 'n' is the DRIVE for that
node. (ie: SET DRIVE=C:)
(Don't worry if this line happens to go past 80 characters.)
Why in the world are we changing that for, you ask?!?! I will
explain AdLogo workings in a little more detail after the
Installation!
Now, we need to add three (3) lines after the DSZ command line.
First, add these two lines:
if exist pcbdsz.lst del pcbdsz.lst
if exist adlogo.lst del adlogo.lst
And last, we have to add one more DEL command to the batch file.
if exist n:\temp%NODE%\*.zip del n:\temp%NODE%\*.zip
This will remove any files that were moved over to the TEMP
directory by AdLogo.
Your new PCBSZ.BAT file should look like this..
@echo off
if exist pcberr.fil del pcberr.fil
if exist pcbdsz.log del pcbdsz.log
AdLogo C:\PCB\ADLOGO.CFG %NODE% %3
DSZ port %1 ..... @ADLOGO.LST
if exist pcbdsz.lst del pcbdsz.lst
if exist adlogo.lst del adlogo.lst
if exist n:\temp%NODE%\*.zip del n:\temp%NODE%\*.zip
That's it!! Save your new PCBSZ.BAT file it's complete! If you have
added other external protocols to your PCBoard system, you can follow
the same instructions above to add AdLogo and it's workings to all of
your external protocol's batch files. Just make sure that the AdLogo
command line is somewhere BEFORE the command line for the external
protocol and that the last three lines are added at the end.
Ooops, one more thing, PKZip.EXE must be in one of your DOS'S PATHS!
AdLogo v1.4ßeta Page 5
HOW IT WORKS
------------
AdLogo first determines if the transfer is a SINGLE file transfer or
a BATCH transfer.
If it is a SIGNLE file transfer, AdLogo will then read the %3 parameter
that is passed to it and determine if that file is located on one of the
Drives that is pointed to by <CD-ROM>. If the file IS on a MATCHED drive,
AdLogo will copy the file over to the TEMP directory, pointed to by
<TEMPDIR> AND %NODE%, and then will execute PKZip and add your board's
'Logo' to that file. AdLogo will then create a file called ADLOGO.LST
in the current PCB Node's directory, and write the new path of the file
that contians your board's 'Logo'. AdLogo will then exit and the
external protocol will then read ADLOGO.LST and begin transfer of that
file.
If AdLogo detects that a BATCH transfer is about to begin, AdLogo will
read each line of PCBDSZ.LST (this is the file that is created by PCBoard
for batch transfers). As each line is read, AdLogo will do the same as
it does for the SINGLE file transfer.
If, during either a SINGLE file or Batch transfer, the file, or any of
the files, selected are NOT a .ZIP file, or NOT on a MATCHED drive,
AdLogo will simply copy the path of the file to AdLogo.lst. This is
why we changed the %3 in the DSZ command line to @ADLOGO.LST.
AdLogo will create ADLOGO.LST EVERYTIME it is executed.
PROGRAM COMPATABLILTY
---------------------
There are some DOORS for PCBoard that have the option of using PCBoard's
external protocol batch files to send and receive information. One of
these DOORS is the ever popular Qwik Mail Door from SparkWare. With the
addition of AdLogo in these selected batch files that QMail may also use,
you are probably wondering if AdLogo is compatable with these 'Other
Programs'. The answer to this question is YES!
For example, a user opens a mail door and wishes to download a mail packet.
The door scans for new mail, prepairs it, archives it, and then calls on
the PCBSZ.BAT (Zmodem, for this example) to start the file transfer.
Even though AdLogo works with ZIP files, AdLogo will detect that the file
to be transfered is a mail packet, and will do nothing to that file. It
will leave the file in place, and simply pass the parameter of the path
of the mail packet file to the external protocol.
AdLogo v1.4ßeta Page 6
LEGAL STUFF
-----------
As much as we all hate this, I must too add this in just to keep every-
thing on the up-and-up!
ADLOGO AND ALL OF IT'S ASSOCITATED FILES ARE RELEASED TO THE PUBLIC AS
SHAREWARE. TMC SOFTWARE RETAINS ALL COPYRIGHTS TO THESE UTILITIES AND
DOCUMENTATIONS.
ADLOGO MAY BE DISTRIBUTED TO THE PUBLIC AS LONG AS THE ARCHIVE FILE
THAT ADLOGO.EXE IS CONTAINED IN IS ALTERED IN ANYWAY OR FORM. THIS
MEANS THAT NO FILES MAY BE ADDED TO THIS ARCHIVE WITHOUT PRIOR WRITTEN
CONSENT FROM TMC SOFTWARE DEVELOPMENT. THE EXCEPTION TO THIS IS ONLY
TO THE ZIPCOMMENT THAT THIS ARCHIVE CONTIANS. NO BBS ADS IN THE FORM
OF TEXT FILES, EXECUTABLE .EXE OR .COM FILES, OR IN ANY OTHER FORM ARE
PERMITTED TO BE ADDED.
I, MICHAEL J. CAMBRA, TMC SOFTWARE DEVELOPMENT, OTS DEVELOPMENT CORP, ARE
IN NO WAY LIABLE FOR ANY DAMAGES, EITHER IN THE FORM OF HARDWARE OR
SOFTWARE, TIME LOST, OR MOENY(IES) LOST, DUE TO THE OPERATION OF
ADLOGO.EXE AND ITS SUPPLIMENTERY UTILITIES.
Adlogo has been put through a number of tests. Many efforts has been
placed into the code to prevent any kind of accidental damaging occuring.
However, before installing this software, as it is a good practice
before installing ANY new software, to make a backup of your important
system files.
AdLogo v1.4ßeta Page 7
REGISTRATION
------------
AdLogo is SHARWARE. You may try this program out for a period of no
more than 30 days from the date of installation. After this 30 period
has expired, you are required to either register this software, or
remove the software from your system and discontinue its use.
The Registration fee for AdLogo v1.4ßeta is currently $15.00 (US).
When the first official version is released, the registration fee
will incress to $25.00 (US).
Upon registering AdLogo, you will receive the following:
-- AdLogo ENHANCED version
-- Personal Serial Number
-- Free future updates.
-- Advanced noticed on future updates (Two weeks - Nonßeta versions)
-- Complete set of batch files to add to PCBoard for AdLogo to
run under XModem, XModem(CRC), 1k-XModem, YModem, & Ymodem/G
-- Free One Year access to The "Port of Call" BBS
& The 'Port of Call-East' BBS for instant support and the
lastest version of AdLogo
-- Voice Support
To register your copy of AdLogo, print out REGISTER.FRM, complete it,
include either a Check or Money Order made out to Michael Cambra, and
mail it to:
The 'Port of Call-East'
c/o Michael Cambra
20 Nonquit Ln.
Tiverton, RI. 02878-4814
ATTN: TMC SOFTWARE
AdLogo v1.4ßeta Page 8
SUPPORT
-------
For the lastest updates to support, you can call the following boards:
Indiana - The "Port of Call" BBS
(219)-763-2091 <CompuCom>
(219)-763-1940 <HST> - Registered Users Only
Join Conference # 69
Address Messages to MIKE CAMBRA
Rhode Island - The 'Port of Call-East'
(401)-624-6541 <v.32bis>
Address Messages to SYSOP
Join Conference #216
Address Messages to SYSOP or MIKE CAMBRA
AdLogo will be released as ADLG*.ZIP
(*= Version number, release number, & B for Beta versions)
Or, you can contact me by E-Mail via the following Networks:
NorthAmericaNet (NANET) MIKE CAMBRA
New England Net (NENET) MIKE CMABRA
Medical Net (MEDINET) MIKE CAMBRA
AdLogo v1.4ßeta Page 9
ACKNOWLEDGEMENTS
----------------
I wish to thank Brian Cload, Sysop of The "Port of Call" BBS
for all the help and support he has given me during the ßeta
testing of AdLogo and putting it thru all the tests and finding
all those 'Typos' in the docs! Guess that's what happens when
your looking at the code for 13 hours stright!
TRADEMARKS
----------
PCBoard...............................Clark Development Co.
Qwik Mail Door (QMail)................Sparkware
PKZip.................................PKWare, Inc.
North America Net.....................Canada Remotes Systems
New England Net.......................Mike Labbe/Eagle's Nest Network
Medical Net...........................Gary Hedberg
DSZ...................................Omen Tech, Inc.
HS/Link...............................Sam H. Smith/Tool Shop BBS
OTS Software Development Corp.........Brian Cload/
The "Port of Call" BBS
AdLogo v1.4ßeta Page 10
.CFG FILE
---------
The .CFG file for AdLogo is a simple text file made up of a total of
8 lines. Any text editor can be used to create/edit this file.
The format of the file is as follows:
Line 1 - Your Name (32 chars max)
Line 2 - Serial # (00000 if UNREGISTERED)
Line 3 - PassCode (0000000000 if UNREGISTERED)
Line 4 - CD-ROM (or Hard Drive) Drive Letters
Line 5 - TEMP directory
Line 6 - FULL Path & Filename of ZipComment (BBS LOGO)
Line 7 - FULL PAth and Filename of Callers Log file
(Do NOT Place a node number here if running MultiNode!)
Line 8 - Y or N (Y=MultiNode System, N=Single Node)
A Sample .CFG file is included in the archive. You can simply edit this
file as needed. However, Line 2 MUST be five (5) 0's (Zeros) and
Line 3 MUST be ten (10) 0's (zeros) if you have not registered your
copy of AdLogo.
After editing this file, copy it to the directory the same directory
where you placed AdLogo.EXE.
REMEMBER, even though AdLogo.exe and AdLogo.CFG (or whatever you
name your configuartion file), you MUST give the AdLogo commnad line
the FULL DRIVE:\PATH\FILENAME.EXT of this file!!